home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / misc / idfreq13 / idfreqs.doc < prev    next >
Text File  |  1991-07-23  |  5KB  |  113 lines
  1.                              IDFREQS version 1.3
  2.  
  3. IDFREQS (IDentify FREQuencieS) is a program written for scanner owners
  4. that allows them to print out a list of all frequencies stored in their
  5. scanner, along with text descriptions of agencies that use them.  Since
  6. some scanners will actually "round" a frequency when entered, and since
  7. you can actually hear frequencies that are just a few khz off of center,
  8. IDFREQS considers frequencies that are within 3khz of each other as the
  9. same.
  10.  
  11. IDFREQS first loads a file that you create containing channel numbers, 
  12. along with the corresponding frequencies, currently in your scanner.
  13. Next, master frequency data base file(s), that contain frequencies along
  14. with text describing them, are searched to find descriptions of who uses
  15. those frequencies.  If there is enough memory to do so, descriptions for
  16. each frequency are sorted alphabetically.  The results of the search are
  17. written to another file that you specify.  
  18.  
  19. The command line for IDFREQS looks like this:
  20.  
  21. IDFREQS <FILE1> <FILE2a>..<FILE2n> <FILE3>
  22.  
  23. Examples of actual command lines are:
  24. IDFREQS scanner.txt mstrfreq results.txt
  25.   or
  26. IDFREQS scanner.txt mstrfreq.1 mstrfreq.2 results.txt
  27.  
  28. -------------------------------------------------------------------------
  29.  
  30.                                  FILE1 FORMAT
  31. FILE1 is a file you must create yourself which contains the data stored
  32. in your scanner.  This is always the first file listed on the command
  33. line.  Each line contains both the channel number and the frequency
  34. stored in it, terminated by a carraige return/line feed:
  35.  
  36. ccc ffff.ffff<cr>
  37.  
  38. ccc is the channel number, up to 4 digits (0001, etc).  You don't have
  39. to list channels that are not used, but you do have to list the channel
  40. numbers in ascending order, otherwise the output will not be in order.
  41. Note that leading zeros are not necessary, but leading zeros will be put
  42. in when the results are generated.  For example, both 007 or 7 are OK.
  43.  
  44. ffff.ffff is the frequency, up to 9 digits (including decimal point) total.
  45. No more than 4 digits before, and no more than 4 digits after, the decimal
  46. point.  Values in this field do NOT have to be in ascending order, and
  47. duplicates are OK.  If you list a frequency of 0, a "** BLANK CHANNEL **"
  48. description will be listed for that channel.  Note that you don't have to
  49. list all of the digits, just significant ones.  For example, both 0045.3000
  50. or 45.3 are OK.
  51.  
  52. FILE1 should ideally look like:
  53. 0001 042.3250<carriage return/line feed>
  54. 0008 162.6650<carriage return/line feed>
  55. 0400 345.3225<carriage return/line feed>
  56.  
  57. Every character in this file, other than the decimal point, MUST BE A DIGIT!
  58. The delimiter between fields can be space(s) or tab(s).
  59. If you don't follow the format for this file, IDFREQS will fuss and abort!
  60.  
  61. -------------------------------------------------------------------------
  62.  
  63.                             FILE2a..FILE2n FORMAT
  64. FILE2a through FILE2n is/are the master frequency data base(s) to be
  65. searched.  As you see from the command line description above, you can
  66. specify one, or multiple, master frequency data bases.  In other words,
  67. any files listed between FILE1 and FILE3 are considered to be master
  68. frequency databases that you want searched.  Each line contains a
  69. frequency and a text description of that frequency, terminated by a
  70. carriage return/line feed:
  71.  
  72. ffff.ffff ttt...<cr>
  73.  
  74. ffff.ffff is the frequency, up to 9 digits (including decimal point) total.
  75. No more than 4 digits before, and no more than 4 digits after, the decimal
  76. point.  Values in this field do NOT have to be in ascending order, and dup-
  77. licates are OK.  Every character in this field, other than the decimal point,
  78. MUST BE A DIGIT!  Note that you don't have to list all of the digits, just
  79. significant ones.  For example, both 0045.3000 or 45.3 are OK.
  80.  
  81. ttt... is a text description of the frequency and may be up to 100 charac-
  82. ters long.  Anything longer will be truncated.
  83.  
  84. The delimiter between the frequency and text description fields can be
  85. space(s) or tab(s). If any line(s) don't follow the format for this file,
  86. IDFREQS will skip that line and go on to the next.
  87.  
  88. FILE2a..FILE2n should ideally look like:
  89. 042.3250 Atlanta Police Dept.  Dispatch<carriage return/line feed>
  90. 162.6650 Marietta Fire Dept.  Fireground Comms<carriage return/line feed>
  91. 345.3225 Fred's Wrecker Service<carriage return/line feed>
  92.  
  93. -------------------------------------------------------------------------
  94.  
  95. FILE3 is the file that IDFREQS creates, and lists the channel number,
  96. frequency, and descriptions for the frequency (if a description was found).
  97. No, the output is not fancy, but you can edit it and do whatever your 
  98. little heart pleases to it before you print it out.
  99.  
  100. This is shareware, so go ahead and distribute it to whomever or whereever
  101. you like.
  102.  
  103. Feel free to tell me what you think, and suggestions are welcome.  Just
  104. leave me a message.  You may reach me via the following:
  105.  
  106. RelayNet systems : Scanner-SWL conference or Electronics conference
  107. FidoNet systems  : Shortwave conference
  108. Atlanta Area     : Scan Atlanta (404) 763-4369
  109.  
  110.                                     Enjoy! 
  111.  
  112.                                     Lee Greer
  113.